home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / src / exampleCode / inventor / inventorTemplates / README < prev    next >
Encoding:
Text File  |  1994-08-02  |  3.6 KB  |  88 lines
  1.     
  2.      ~4Dgifts/toolbox/src/exampleCode/inventor/inventorTemplates README
  3.  
  4.  
  5.             this is the README file for walk.c++ and player.c++
  6.  
  7.   WALK (walk.c++)
  8.   
  9.   this program is just a walk viewer with one added feature.  When you go out 
  10.   of viewing mode (either by the menu, or by pressing the button on the 
  11.   viewer), you press the 'd' key, it prints the camera location and rotation 
  12.   to stdout.  you can collect these in a file for use with the player.  This 
  13.   program also some added things to see from a example standpoint, such as 
  14.   loading in an inventor file to a viewer, and loading in an env file to a 
  15.   viewer.
  16.   
  17.   the usage for the walk program is as follows:
  18.   walk [-e envfile] inventorfile
  19.   
  20.   
  21.   
  22.   
  23.   PLAYER (player.c++)
  24.   
  25.   the player program takes an inventor file of geometry information and 
  26.   animation file consisting of the following format:
  27.   
  28. keyframe cameraX cameraY cameraZ rotationAxisX rotationAxisY rotationAxisZ rotation
  29.   
  30.   on each line.  It works with the output from player, but you have to add a
  31.   keyframe in front of each line that player spits out.  There are a couple
  32.   example animation files.  One for use with /usr/share/data/models/rook.iv 
  33.   and one for use with /usr/share/data/models/scenes/chesschairs.iv
  34.   
  35.   to run the rook example animation type:
  36.   player -n 50 models/rook.iv rook.animation
  37.   
  38.   to run the chessboard example animation type:
  39.   player -n 50 -l models/chessboard.iv chessboard.animation
  40.   
  41.   
  42.   
  43.   usage for the player is such:
  44.       player [-p] [-v] [-q num] [-l] [-s num] [-e num] [-x width] [-y height] [-n clicks] inventorfilename animationfilename
  45.   
  46.   -p prints out an environment file at the end of animation
  47.       [ this is useful if you are stringing together sets of animations,
  48.          you can use the env file with walk so that you can arrange a 
  49.       seamless animation ]
  50.   -v turns on verbose mode
  51.       [ this just gives a report of what is happening each frame, and tells
  52.         you what frame you are on ]
  53.   -q saves the animation starting at frame num
  54.       [ this is very useful.  It saves each screen of the animation as a 
  55.       file of the form animationXXX.rgb, you can then take these files 
  56.       and import them into makemovie, or you can use it with -s and -e 
  57.       to get still frames of your animation ]
  58.   -l moves the camera linearly between control points
  59.       [ without the -l flag the camera will use splines to determine
  60.         it's location ]
  61.   -s starts the animation at frame num
  62.       [ if you want to start an animation somewhere in the middle, you can
  63.         use this to decide what the starting frame should be ]
  64.   -e ends the animation at frame num
  65.       [ if you want to end the animation before the last keyframe, use this
  66.         option ]
  67.   -x sets the width of the render areas
  68.       [ both on screen and off screen ]
  69.   -y sets the height of the render areas
  70.       [ both on screen and off screen ]
  71.   -n is used for setting a pause between frames
  72.       [ if you are not saving into files, your animation might render
  73.         completely before you even open the window without this option! ]
  74.   
  75.   the player shows one way to animate using inventor.  It was not written to 
  76.   be robust, or especially pretty.  There are a lot of things that could be 
  77.   done to improve it, and would make it easier to use.  things like: a better 
  78.   UI, resizing of the window, letting the user choose the location of the 
  79.   animation files, and a lot more...  It does show how to use Inventor with 
  80.   GL, and how to control your own camera in the scene, and a few other handy 
  81.   things.
  82.   
  83.  
  84.  
  85.   Questions, comments and bug reports can be directed to:
  86.   Kevin Goldsmith
  87.   kmg@colossal.com
  88.